package com.psnoted.backend.repository;

import com.psnoted.backend.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Modifying;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.time.LocalDateTime;
import java.util.Optional;

/**
 * 用户Repository接口
 * 提供用户数据访问方法
 * 
 * @author PSNoted Team
 * @version 1.0.0
 */
@Repository
public interface UserRepository extends JpaRepository<User, Long> {

    /**
     * 根据密钥哈希查找用户
     * 
     * @param keyHash 密钥哈希
     * @return 用户信息
     */
    Optional<User> findByKeyHash(String keyHash);

    /**
     * 根据密钥哈希查找活跃用户
     * 
     * @param keyHash 密钥哈希
     * @param status 用户状态
     * @return 用户信息
     */
    Optional<User> findByKeyHashAndStatus(String keyHash, String status);

    /**
     * 检查密钥哈希是否存在
     * 
     * @param keyHash 密钥哈希
     * @return 是否存在
     */
    boolean existsByKeyHash(String keyHash);

    /**
     * 根据用户名查找用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    Optional<User> findByUsername(String username);

    /**
     * 更新用户最后登录时间
     * 
     * @param keyHash 密钥哈希
     * @param lastLoginAt 最后登录时间
     * @return 更新的记录数
     */
    @Modifying
    @Query("UPDATE User u SET u.lastLoginAt = :lastLoginAt WHERE u.keyHash = :keyHash AND u.status = 'active'")
    int updateLastLoginAt(@Param("keyHash") String keyHash, @Param("lastLoginAt") LocalDateTime lastLoginAt);

    /**
     * 根据密钥哈希删除用户（软删除）
     * 
     * @param keyHash 密钥哈希
     * @param status 状态
     * @return 更新的记录数
     */
    @Modifying
    @Query("UPDATE User u SET u.status = :status WHERE u.keyHash = :keyHash")
    int updateStatusByKeyHash(@Param("keyHash") String keyHash, @Param("status") String status);
} 